========================================
             RACE MOD - GTA V
           Version 1.1 (C# .NET)
========================================

This mod adds a simple but customizable racing
system to GTA V. Players can start a race from
the menu, spawn NPC racers with random vehicles,
and race toward a finish point selected by the
player or automatically generated by the system.

When the player reaches the finish line, a
"Mission Passed" screen will appear in-game.


----------------------------------------
CAUTION
----------------------------------------

- If you press Start Race while not inside a
  vehicle, the mod will NOT work.

- The mod only functions correctly when the
  player is inside a vehicle and then presses
  Start Race.

----------------------------------------
INSTALLATION
----------------------------------------

1. Install ScriptHookV
   (Alexander Blade)

2. Install ScriptHookVDotNet 3.6+
   Copy these files into your GTA V folder:
   - ScriptHookVDotNet.dll
   - ScriptHookVDotNet.xml
   - ScriptHookVDotNet.asi

3. Install NativeUI
   Place NativeUI.dll inside your "scripts" folder.

4. Extract this mod and place:
      RaceMod.dll
   into:
      Grand Theft Auto V/scripts/

Final folder structure:

Grand Theft Auto V/
 └─ scripts/
      ├─ RaceMod.dll
      └─ NativeUI.dll

----------------------------------------
HOW TO USE
----------------------------------------

• Press **F3** to open the Race Menu

MAIN MENU
 ├── Add Race  → (sub-menu)
 │      ├── NPC Vehicle
 │      ├── NPC Count  
 │      ├── star race
 │      └── Back to Menu
 ├── Clear Race
 ├── Repair Vehicle
 └── Close Menu


1. Add race
   - Spawns NPC racers (based on selected amount)
   - NPCs automatically choose a random car
   - NPCs race to your waypoint (if set)
   - If no waypoint is set, finish line is placed
     500 meters in front of the player

2. Clear Race
   - Removes NPC vehicles, drivers, blips, and
     resets race status

3. Repair Vehicle
   - Repairs your current vehicle instantly

4. Close Menu
   - Closes the Race Menu

----------------------------------------
FEATURES
----------------------------------------

• NPCs choose their own random vehicles
• Choose number of NPC racers (1–5)
• NPC AI automatically races toward the finish
• Automatic finish line marker
• NPC position indicators over each vehicle
• Fully working menu system using NativeUI
• Cleaner NPC + vehicle cleanup system

----------------------------------------
REQUIREMENTS
----------------------------------------

• ScriptHookV
• ScriptHookVDotNet 3.6+
• NativeUI
• GTA V (latest version recommended)

----------------------------------------
CHANGELOG
----------------------------------------

v1.1
- Added NPC random vehicle selection system
- Added NPC amount selection (1–5 racers)
- Improved race system + finish line detection
- Improved cleanup system (Clear Race)
- Menu updated to F3 (was F8)
- Menu structure updated with sub-menus
- Official public release

----------------------------------------
CREDITS
----------------------------------------

Created by: kong

----------------------------------------
NOTES
----------------------------------------

1) Race loading may take a moment the first time.
   - NPC models and vehicles load
   - NPCs enter their vehicles
   - Route calculation starts
   - Race begins once loaded

2) If NPCs do not spawn correctly:
   - Press "Clear Race"
   - Then press "Start Race" again

3) To support future development, please Like,
   Follow, and Share this mod.

4) Future versions may include:
   - Full vehicle customization menu
   - Saved race routes
   - Multiple checkpoints
   - Custom NPC AI styles
   - Online-style UI animations